home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / utilit~1 / initsnb.zoo / init / read.me < prev    next >
Encoding:
Text File  |  1992-11-03  |  5.9 KB  |  157 lines
  1. Release 1.0 (3rd November 1992)
  2. -------------------------------
  3.  
  4. This file is the READ.ME file for my init/getty/login suite for MiNT on the
  5. Atari ST/TT range of computers. This file must be kept with the source!
  6.  
  7. This package needs MiNT version 0.90 pre-alpha patchlevel 14 or above.
  8.  
  9. This directory structure contains many directories, init, getty, login and
  10. etc.  When the project is complete these will contain the source for the
  11. "init" process, "getty" process, login and passwd and related config files
  12. for MiNT respectively. Currently, however, only versions of init(8),
  13. login(1), passwd(1), finger(1), write(1), wlogin(1) (for MGR), ac(8),
  14. last(1), a modified copy of sh(1) (ie fixed) and who(1) have been written.
  15. The etc directory contains sample config files.
  16.  
  17. All the manual pages for the programs are held in the man directory.
  18. Currently, not all the programs have manual pages written for them, this is
  19. in the process of being remedied.
  20.  
  21. How to compile:-
  22.  
  23. 1st) Copy the header files in the include directory into the directory which
  24.     normally holds your C header files.
  25.  
  26. 2nd) Edit the makefile in this directory so that it fits your system.
  27.  
  28. Either
  29.  
  30. 3rd) Type make.
  31.  
  32. Or if you don't have enough memory for make
  33.  
  34. 3rd) Examine the makefile and manually copy the executables from the
  35.     directories into their proper places.
  36.  
  37. How to use:-
  38.  
  39. Copy all the files except mint.cnf from the etc directory into a directory
  40. called /etc on the drive which holds the mint executable. (If you want a log
  41. of logins, create an empty file in /var/adm called wtmp.)
  42.  
  43. Edit the ttytab file so that the command in quotes points to the program you
  44. want init to start up on each of the terminal lines (use the FULL pathname).
  45. Usually this will be either the getty executable or the login executable.
  46.  
  47. Edit the passwd file so as to add an account for yourself. The format of the
  48. passwd file is identical to that of the Unix passwd file. (remember to set
  49. up your default shell)
  50.  
  51. ** The root password in the sample passwd file is "secret" **
  52.  
  53. Note. If you don't use the MiNT unified filesystem (you'll be silly if you
  54.     don't), the path sections of the passwd file are in the    format:-
  55.         /dev/<drive letter>/<path>
  56.  
  57. Edit the mint.cnf file supplied in the "etc" directory so as to reflect your
  58. own set-up and copy it to the same directory as your mint.prg.
  59.  
  60. Make a copy of your favourite Bourne-like shell to /bin/sh.ttp.
  61.  
  62. Type "make install"
  63.  
  64. Run MiNT.
  65.  
  66.    -------
  67. ** Warning **
  68.    -------
  69.  
  70. Dave Gymer and I have tested this as well as we can, but there still could
  71. be some bugs (and there very probably are!), therefore, to protect ourselves
  72. we must include the following statement:-
  73.  
  74. This is still an early version of this software. As far as we can tell it
  75. will work, but, there are no guarantees as to it's usefullness or fittness
  76. for any purpose whatsoever.
  77.  
  78. By using this software you agree to take full responsibility for any actions
  79. this software makes, including all possible damage to files, hardware (can
  80. it?) and software.
  81.  
  82. Licence:
  83. --------
  84.  
  85. This software is copyright 1991/1992 Stephen R. Usher and Dave Gymer.
  86.  
  87. Some parts were written by other people, to see who please read the sources
  88. provided.
  89.  
  90. The code written by Stephen R. Usher has the following licence conditions.
  91.  
  92. You are allowed to copy, distribute and modify the source code included in
  93. this package as long as the following conditions are met:-
  94.  
  95. (1) This file is kept with all the other files in this distribution.
  96.  
  97. (2) Any files which are modified by you are clearly maked as such and that
  98.     you take full responsibility for the code you modify.
  99.  
  100. (3) You may not sell this package for more than double the cost of copying
  101.     the files onto the media (including the cost of the media), excluding
  102.     any local taxes.
  103.  
  104. You may terminate this licence at any time by destroying all original and
  105. modified copies of this package.
  106.  
  107. You are deemed to have agreed with the terms of this licence if you have a
  108. copy of this program in your posession.
  109.  
  110. If you are resident in, and the package has been supplied in, the United
  111. States of America, it is agreed that the laws of California shall govern
  112. without reference to the place of execution or performance, except as to
  113. copyright matters which are covered by Federal laws. If you are resident,
  114. and the package has been supplied, elsewhere othr than in the United States
  115. of America, it is agreed that the laws of England shall govern without
  116. reference to the place of execution or performance.
  117.  
  118. Code written by Dave Gymer is licenced under the GNU public licence.
  119.  
  120. Code written by other people is licenced under the terms given in the source
  121. code.
  122.  
  123. What does it run on?
  124. --------------------
  125.  
  126. This suite of programs has been tested on Atari STM/FM, Mega ST (TOS 1.2,
  127. 1.4) and TT (TOS 3.05) series of computers running MiNT 0.91, 0.92, 0.93,
  128. 0.94, 0.95 and pre-release versions of 0.96. The baud rate of the serial
  129. ports can only be set by getty under MiNT versions 0.95 and above.
  130.  
  131. Stephen Usher 3rd November, 1992.
  132.  
  133. Acknowledgements.
  134. -----------------
  135.  
  136. Dave Gymer for getty(8), write(1), wlogin(1), ac(8) and his suggestions for
  137. the improvement of the rest of the package.
  138.  
  139. Alec Muffett, Robert Baldwin and Icarus Sparry for the fcrypt() routine used
  140. in login(8). (But especially Alec, for being a good friend and sending me a
  141. copy of a pre-release version of the routine. His main handicap is that he
  142. is an Amiga owner ;-))
  143.  
  144. Eric Smith and his merry band of helpers for MiNT, without which none of
  145. this would be possible :-).
  146.  
  147. Kenneth Almquist for writing ash and Stephen Neuhaus for porting it to MiNT.
  148. There were two major bugs which I fixed, the first to do with running shell
  149. scripts (it wasn't finding executables with extentions) and the second was
  150. to do you job control. The files modified were exec.c and jobs.c.
  151.  
  152. Terrence W. Holm for last(1).
  153.  
  154. Atari, for a series of computers which don't use Intel "micro-processors".
  155. Pitty their filesystem is slow (probably caused by having to do everything in
  156. a little-endian format) and their documentation is sparse.
  157.